The Panel Information Structure(IM:XP)

Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

User Interface Constants and Data Types

The Panel Information Structure
The panel information structure, of data type gxPanelInfoRecord, provides information to the panel about the current dialog box and panel event. This structure
is used with the GXHandlePanelEvent and GXFilterPanelEvent messages, whose descriptions begin on page 4-85.
struct gxPanelInfoRecord {
   gxPanelEvent   panelEvt;
   short          panelResId;    
   DialogPtr      pDlg; 
   EventRecord    *theEvent;
   short          itemHit;
   short          itemCount;
   short          evtAction;  
   short          errorStringId;    
   gxFormat       theFormat;
   void           *refCon;    
};
typedef struct gxPanelInfoRecord gxPanelInfoRecord;
Field Description

panelEvt
The event to filter or handle.
panelResId
The resource ID of the current panel ('ppnl') resource.
pDlg
A pointer to the dialog box structure.
theEvent
A pointer to the event that occurred.
itemHit
The actual item number where the event occurred, using the item-numbering scheme of the Dialog Manager.
itemCount
The item count before your panel's items in the dialog box.
evtAction
The action that results once this event is processed. This value is one of the constants defined in the panel event actions enumeration, which is described on page 4-38. This field is only meaningful for filtering, and is used for parsing.
errorStringId
The ID of the 'STR ' resource to put in the error alert. A value of 0 in this field indicates that there is no error string to display.
theFormat
The current format. This is only meaningful in a Custom Page Setup dialog box.
refcon
A reference constant for use by the generator of the panel.